home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / hof100.zip / HOF.DOC < prev    next >
Text File  |  1992-02-24  |  5KB  |  113 lines
  1.                                 GLOBAL WAR
  2.                                 ~~~~~~~~~~
  3.                       Copyright 1989-1992 Joel Bergen
  4.                      ProVision BBS: (206) 353-6966 HST
  5.                        (206) 353-2494 300/1200/2400
  6.                              Fidonet 1:343/65
  7.  
  8. DESCRIPTION
  9. ~~~~~~~~~~~
  10. HOF is a Hall Of Fame utility for Global War.  It requires Global War
  11. version 2.40 or later.  This program will create a BULLETIN.ANS bulletin
  12. file which will display the last 6 winners of the Hall of Fame.
  13.  
  14. HOW DOES IT WORK
  15. ~~~~~~~~~~~~~~~~
  16. Beginning with Global War version 2.40, you can configure Global War to
  17. automatically reset your rankings whenever a player reaches a certain
  18. rank (usually 5-Star General).  When a player reaches this rank, the
  19. WINNERS.WAR file (the file in which rankings are stored) is saved under
  20. the name of WINNERS.TOP and then WINNERS.WAR is deleted so that the
  21. rankings can start over again.  What HOF does is read this WINNERS.TOP
  22. file to get the top player's name.  The top player's name is then added
  23. to your BULLETIN.ANS file (Global War's opening bulletin).  HOF will
  24. keep track of the last 6 players to win the Hall of Fame.  Players will
  25. enjoy competing to see who will have the glory of seeing their name "up
  26. in lights".
  27.  
  28. INSTALLING HOF
  29. ~~~~~~~~~~~~~~
  30. Installing HOF is very simple.  Copy HOF.EXE and HOF.ANS into your
  31. Global War subdirectory (the same subdirectory where you have WAR.EXE).
  32. Then, edit your WAR.BAT file (or whatever you have named your batch file
  33. that executes Global War).  Add two lines to your batch file as follows:
  34.  
  35. cd \bbs\globlwar
  36. war /r \bbs\dorinfo1.def
  37. if exist winners.top hof              <- add this line
  38. if exist winners.top del winners.top  <- and this line
  39. cd \bbs
  40.  
  41. CUSTOMIZING HOF
  42. ~~~~~~~~~~~~~~~
  43. When HOF executes, it does the following steps:
  44.  
  45. 1. Reads HOF.DAT to get the names of past Hall of Famer's.
  46. 2. Deletes the oldest name from the list to make room for the new winner.
  47. 3. Reads WINNERS.TOP to get the name of the new winner.
  48. 4. Saves the new name list to HOF.DAT.
  49. 5. Reads HOF.ANS into memory.
  50. 6. Adds the 6 names & dates to the copy of HOF.ANS in memory.
  51. 7. Writes BULLETIN.ANS (overwriting it if it exists).
  52.  
  53. HOF.ANS is your template writing BULLETIN.ANS.  You may edit HOF.ANS if
  54. desired.  I recommend using an ansi file editor such as TheDraw to edit
  55. HOF.ANS.  When you edit HOF.ANS you'll see something like this:
  56.  
  57.             DOWNLOAD GWTERM FOR INSTANT MAPS AND MOUSE SUPPORT!
  58.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  59.    ░▒▓████▓▒░░▒▓█▓▒░░▒▓█▓▒░     HALL OF FAME    ░▒▓█▓▒░░▒▓█▓▒░░▒▓████▓▒░
  60.     ░▒▓██▓▒░  @═════════════════════════════════════════════@  ░▒▓██▓▒░
  61.     ░▒▓██▓▒░  │ 11111111111111111 Awarded AAAAAAAAAAAAAAAAA │  ░▒▓██▓▒░
  62.     ░▒▓██▓▒░  │ 22222222222222222 Awarded BBBBBBBBBBBBBBBBB │  ░▒▓██▓▒░
  63.     ░▒▓██▓▒░  │ 33333333333333333 Awarded CCCCCCCCCCCCCCCCC │  ░▒▓██▓▒░
  64.     ░▒▓██▓▒░  │ 44444444444444444 Awarded DDDDDDDDDDDDDDDDD │  ░▒▓██▓▒░
  65.     ░▒▓██▓▒░  │ 55555555555555555 Awarded EEEEEEEEEEEEEEEEE │  ░▒▓██▓▒░
  66.     ░▒▓██▓▒░  │ 66666666666666666 Awarded FFFFFFFFFFFFFFFFF │  ░▒▓██▓▒░
  67.     ░▒▓██▓▒░  @═════════════════════════════════════════════@  ░▒▓██▓▒░
  68.     ░▒▓██▓▒░  ░▒▓▒░ ░▒▓█▓▒░  ┌──┴────────┴──┐   ░▒▓█▓▒░ ░▒▓▒░  ░▒▓██▓▒░
  69.     ░▒▓██▓▒░ ░▒▓█▓▒░ ┌───────┴──────────────┴──────┐   ░▒▓█▓▒░ ░▒▓██▓▒░
  70.    ░▒▓████▓▒░ ┌──────┴─────────────────────────────┴────────┐ ░▒▓████▓▒░
  71.    ┌──────────┴─────────────────────────────────────────────┴──────────┐
  72.    │  When a player reaches 5-Star General his name will be added to   │
  73.    │        this hall of fame and the rankings will be reset.          │
  74.  
  75. Note the filds "11111111111111111", "AAAAAAAAAAAAAAAAAA",
  76. "22222222222222222", and so on.  These define where HOF is to place the
  77. player's names and the dates in which they won the Hall of Fame.  The
  78. "111..." field is where the last player to win the Hall of Fame's name
  79. will be placed.  "AAA..." is where his date will be placed.  His
  80. predecessor's name will be moved down to the "222..." field, with his
  81. predecessor's date moving to the "BBB..." field and so on.  Note that
  82. there are a total of 17 1's, 17 A's, 17 2's etc in the file.  There must
  83. be exactly 17 characters, no more, no less.  You may change HOF.ANS any
  84. way you like, but these 12 17-character fields must be somewhere in the
  85. file.
  86.  
  87. When you save HOF.ANS, it is recommended that you do not clear the
  88. screen.  In TheDraw, save the file using the following steps:
  89.  
  90.         Hit Alt-B
  91.         Move the cursor to the upper left corner of the picture
  92.         Hit the spacebar
  93.         Move the cursor to the lower right corner of the picture
  94.         Hit the spacebar
  95.         Select S)ave
  96.         Select A)nsi
  97.         Select N)one
  98.         Press ENTER
  99.         Press ENTER
  100.         Type in the filename HOF.ANS
  101.  
  102. IN CONCLUSION
  103. ~~~~~~~~~~~~~
  104. I hope you find HOF useful and that your players enjoy competing for
  105. glory as much as mine do.  This program is free.  Please pass it on to
  106. other sysops.  The Turbo Pascal source code is included in SOURCE.ZIP
  107. for anyone who wishes to see how it works or modify it as desired.  If
  108. you have any comments or suggestions I'd love to hear them.  I can be
  109. contacted at my BBS.  The numbers are posted at the top of this file.
  110.  
  111.                             Happy Wargaming!
  112.                               Joel Bergen
  113.